home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 46 / Amiga Format CD46 (1999-10-20)(Future Publishing)(GB)[!][issue 1999-12].iso / -serious- / programming / other / hexy / hexy.readme < prev    next >
Text File  |  1999-09-06  |  5KB  |  134 lines
  1. Short: Binary file viewer/editor v1.6 (w/src GPL)
  2. Author: andrew.ab2000@bigfoot.com (Andrew Bell)
  3. Uploader: andrew.ab2000@bigfoot.com (Andrew Bell)
  4. Type: dev/misc
  5.  
  6. This archive contains the C/Asm source code to Hexy version 1.6 and
  7. the required executable binaries.
  8.  
  9. ------------------------------------------------------------------------
  10. INTRODUCTION
  11.  
  12. Hexy is an unfinished binary file viewer/editor for the Amiga. It has
  13. been released with it's source code under the GNU General Public License.
  14.  
  15. I'm no longer working on this software, feal free to continue working
  16. on it. If you plan to do this, please contact me before hand. I might
  17. be able to assist you.
  18.  
  19. ------------------------------------------------------------------------
  20. FEATURES
  21.  
  22.  o Very fast.
  23.  o ASCII or HEX views
  24.  o Built in editor for HEX and ASCII modes.
  25.  o Supports decompression (via XFD and XPK).
  26.  o Very easy use.
  27.  o View the hunk structure of an executable file. Jump to the location
  28.    of individual hunks and view/edit them.
  29.  o Find window (foward and backward searches).
  30.  o Jump to offset window (support for hex and decimal values).
  31.  o Split large files.
  32.  o Iconification of GUI.
  33.  o Very very free, please send me lots of money if you like it :)
  34.  
  35. ------------------------------------------------------------------------
  36. LIMITATIONS
  37.  
  38.  o Unfinished.
  39.  o Very ugly gadtools GUI, hard coded to a 640x256 hires screen.
  40.  o Never been tested on an NTSC setup.
  41.  o Still some bugs in there.
  42.  o Scroll bar messes up with large files (approx. 4MB).
  43.  o XFD decompression code is buggy i.e. it's not working :o)
  44.  o Poorly documented :o)
  45.  
  46.  (This is why I released it under the GNU GPL, I'm hoping someone
  47.   will update it :)
  48.  
  49. ------------------------------------------------------------------------
  50. REQUIREMENTS
  51.  
  52.  o Amiga OS 3.x
  53.  o reqtools.library version 38+
  54.  o xpkmaster.library version 5 for XPK file decompression.
  55.  o xfdmaster.library for general file decompression.
  56.  
  57. ------------------------------------------------------------------------
  58. USAGE
  59.  
  60.  Sorry for the short document, but Hexy is quite easy to use. When
  61.  viewing a file, use the cursor keys to move around. It is quite
  62.  obvious what all the buttons and pull down menus do.
  63.  
  64.  When editing a file, press the "Edit" tick box. A small cursor will
  65.  appear in the main window. From now on you can edit binary files,
  66.  be careful though! To save a modified file, selected "Save file..." from
  67.  the menu. Press the "Edit" tick box again to stop editing.
  68.  
  69.  Hexy also has a basic Shell interface:
  70.  
  71.  FILE,ASCII/S:
  72.  
  73.  FILE is the name of the file to load.
  74.  ASCII/S forces Hexy to startup in ASCII mode (the default is hex).
  75.  
  76. ------------------------------------------------------------------------
  77. ABOUT THE SOURCE CODE
  78.  
  79. It has been released under the GNU General Public License.
  80.  
  81. To compile it, you need the Amiga OS includes. They have not been included
  82. due to copyright reasons. Hexy was compiled with Hisoft C++ 4.1 using
  83. includes release 40.15.
  84.  
  85. You also need an assember and a linker, I recommend the PhxAss assembler
  86. version 4.39 (or newer) by Frank Wille. It is freely available on the Aminet.
  87.  
  88. Feal free to contact me about the sources via email. Please note, that
  89. Hexy is one of my private projects and was never meant to be released
  90. to the public (and it shows :). It was started in early 1998 and still
  91. contains a lot of bugs :) The source code is a mess, but there may be
  92. some useful hints or tricks in there.
  93.  
  94. One major problem with hexy is the GUI. It stinks, it's hard coded
  95. to a 640x256 hires screen, it's has never been tested on an NTSC
  96. setup. I'd hate to think what would happen on a gfx card system!
  97.  
  98. Another problem with Hexy - it's unfinished.
  99.  
  100. Anyway, I cleaned up the source code, removed some long standing bugs
  101. and fixed it to compile under Hisoft C++ (it was originally compiled
  102. with DICE version 3 by Matt Dillon, now freely available on the Aminet).
  103.  
  104. If I didn't release this source, it would have just sat on my HD forever
  105. - forgotten about. So I've decided to release it under the GNU General
  106. Public License.
  107.  
  108. ------------------------------------------------------------------------
  109. DIRECTORY STRUCTURE
  110.  
  111. The src/ directory contains the source code and the bin/ directory
  112. contains the executable for Hexy. reqtools.library has also been included,
  113. this library is *NOT* covered by the GNU General Public License.
  114.  
  115. ------------------------------------------------------------------------
  116.  
  117. If this source interests you, I'm available for freelance Amiga
  118. programming work. Contact me via my email address below.
  119.  
  120. ------------------------------------------------------------------------
  121.  
  122. This source code and all related files are Copyright © 1999 Andrew Bell.
  123.  
  124. email: andrew.ab2000@bigfoot.com (Andrew Bell)
  125.   WWW: http://www.homeusers.prestel.co.uk/ab2000
  126.  
  127. ------------------------------------------------------------------------
  128.  
  129.            Andrew Bell, Sunday the 22nd of August 1999, 23:45:00
  130.  
  131.                        Going, going, going, gone...
  132.  
  133.  
  134.